home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_game / pjtriv20.zip / TRIVIA.DOC < prev    next >
Text File  |  1996-01-01  |  21KB  |  481 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.      _____________________________________________________________________
  19.  
  20.  
  21.  
  22.  
  23.                                 PJ Trivia v2.0
  24.                                        
  25.                                   Written by
  26.  
  27.                                  Rob Williams
  28.                                  WCS Software
  29.  
  30.  
  31.  
  32.      _____________________________________________________________________
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.                             Copyright Notice
  55.                             ----------------
  56.  
  57.      This door game is distributed under the SHAREWARE concept.  This
  58.      concept gives you the chance to "try before you buy", and see if it
  59.      meets your needs.
  60.  
  61.      I've decided to break away from the standard "30 day trial period"
  62.      that many door authors are using and instead go to a much simpler
  63.      and more realistic policy. This is simply; Try it on your BBS.
  64.      If you like it and your users like it, then register it.  If it's not
  65.      good enough to register, then delete it.
  66.  
  67.      While I'd like you to register my doors as soon as possible, I'm also
  68.      realistic enough to know that different boards have different requirements
  69.      and interests, and sometimes it takes longer befor a game catches on, or a
  70.      sysop can get to the Doors on his list to register.  And frankly, I'd
  71.      rather you ran it for awhile and register, than try it for a short
  72.      period of time and delete it. Nobody wins that way...I lose out on a
  73.      registration and your users lose out on the chance of having the
  74.      registered door to play.
  75.  
  76.      The above "extended trial" statement was copied with permission from
  77.      Mike Jordan of M&S Doors.
  78.  
  79.      Once registered, you will also be allowed to use other functions in the
  80.      TRIVEDIT program.  Registration is good for any future versions of the
  81.      product.
  82.  
  83.      As a shareware  program, PJ Trivia  may be freely distributed.
  84.      Shareware distributors may distribute copies of PJ Trivia on disk
  85.      for a modest disk duplication charge not to exceed $4 per disk.
  86.  
  87.  
  88.  
  89.                                     Warranty
  90.                                     --------
  91.  
  92.      PJ Trivia is distributed on as as is basis.  In no event will
  93.      Rob Williams or WCS Software be liable to you for damages, including 
  94.      any loss of profits, lost savings, or other incidental or
  95.      consequential damages arising out of your use of or inability to use 
  96.      this program, even if Rob Williams, WCS Software, or an authorized 
  97.      representative has been advised of the possibility of such damages.  
  98.      Rob Williams and WCS Software will not be liable for any such claim 
  99.      by any other party.
  100.  
  101.  
  102.                             Features of PJ Trivia
  103.                             ---------------------
  104.  
  105.      Assembly language serial input/output routines for maximum speed.
  106.  
  107.      Fully supports high speed modems: 16550 FIFO buffering and locked
  108.      serial ports.
  109.  
  110.      Built in ANSI terminal emulator.  No need to have ANSI.SYS loaded in
  111.      memory.
  112.  
  113.      DesqView, Windows, and OS/2 aware.
  114.  
  115.      Supports all of the most popular door data file formats:
  116.      TriBBS, PCBoard, GAP  (DOOR.SYS), Spitfire, WildCat!,  RBBS, and WWIV.
  117.  
  118.      ANSI and ASCII Bulletins of high scorers.
  119.  
  120.      Automatic monthly maintenance with no intervention from the Sysop.
  121.  
  122.      Ability to enter, edit, print, import and export questions from the
  123.      database. (some features in registered version only)
  124.  
  125.      Supports play ahead and make up days when registered.  This is
  126.      completely sysop configurable.
  127.  
  128.      Now PJ Trivia is Multinode Aware!
  129.  
  130.  
  131.                          Files used in the Program
  132.                          -------------------------
  133.  
  134.      TRIVIA.EXE    -   The main trivia program
  135.  
  136.      TRIVEDIT.EXE  -   The user/question maintenance program
  137.  
  138.      REGISTER.FRM  -   Information on registration
  139.  
  140.      QUESTION.DAT  -   Question database
  141.  
  142.      SAMPLE.CFG    -   Sample configuration file
  143.  
  144.      SAMPLE.BAT    -   Sample batch file to run PJT
  145.  
  146.      HISCORE.DAT   -   Created when the program runs-contains hi score info
  147.  
  148.      USER.DAT      -   Created when the program runs-contains user info
  149.  
  150.      TRIVIA.KEY    -   Key file for registered versions
  151.  
  152.      TRIVIA.USE    -   Created when the game is running, will be deleted
  153.                        when the user exits normally.
  154.  
  155.      ************************************************************************
  156.      ** IMPORTANT - The game will not run if this file (TRIVIA.USE) exists **
  157.      ************************************************************************
  158.  
  159.      TRIVIA.HLP    -   Help file for the game.  When the Instructions option
  160.                        is selected, this file is displayed.  You may edit
  161.                        this file if you wish.  It is a plain ASCII text file.
  162.  
  163.      TRIVIA.HIS    -   History of the product.  Shows what enhancements were
  164.                        made in what version.
  165.  
  166.      WCSINFO.TXT   -   A text file explaining more about WCS Software and
  167.                        showing all currently available WCS Software programs.
  168.  
  169.      READ.ME       -   A brief text file explaining how to get up and running
  170.                        quickly.
  171.  
  172.      NOBEEP        -   If this file exists in the game directory, the game
  173.                        not make noises when you play it (either remotely or
  174.                        locally)  Good for those sysops who play games locally
  175.                        late at night <grin>.
  176.  
  177.      INTERBBS.DOC  -   A document explaining how to set up WCS Oil to
  178.                        run in an InterBBS League.
  179.  
  180.   *************************************************************************
  181.   ***  IT IS VERY IMPORTANT TO READ THIS FILE FULLY BEFORE ATTEMPTING   ***
  182.   ***  TO RUN WCS OIL IN AN INTERBBS LEAGUE.                            ***
  183.   ***  YOU SHOULD ALSO BE WELL VERSED IN FIDO TERMINOLOGY.              ***
  184.   *************************************************************************
  185.  
  186.      DBRIDGE.HLP   -   Help file for people running D'Bridge mailers.  Also
  187.                        helpful as a fallback if you have problems getting
  188.                        the score files automatically processed. (for InterBBS
  189.                        use)
  190.  
  191.      WCSDOORS.FAQ  -   Frequently asked questions about WCS Software Doors.
  192.                        If you are having a problem with either WCSOil or
  193.                        the InterBBS portion, read this file first for help.
  194.  
  195.  
  196.                           Setting up PJ Trivia
  197.                           --------------------
  198.  
  199.      PJ Trivia is run by  entering a command similar to the
  200.      following:
  201.  
  202.      TRIVIA TRIVIA.CFG
  203.  
  204.      The configuration file can have any name you choose, but it must
  205.      reside in the same directory as the door.  The configuration file is
  206.      an ASCII text file with the following format:
  207.  
  208.      Line 1:   Door data file type.
  209.      Line 2:   Path to the door data file(s).
  210.      Line 3:   BBS name.
  211.      Line 4:   Sysop's name.
  212.      Line 5:   Locked baud rate.
  213.      Line 6:   ASCII High Score Bulletin Name
  214.      Line 7:   ANSI High Score Bulletin Name
  215.      Line 8:   Number of Questions per day (a number between 5 and 30)
  216.      Line 9:   Comments file
  217. *    Line 10:  Number of extra days allowed for make up days
  218. *    Line 11:  Day to start playing make up days-31 to disable
  219.      Line 12:  Write log files (explained below)
  220. *    Line 13:  Line to display a message (donated by, etc)
  221.      Line 14:  InterBBS Play (Y or N)
  222.  
  223.      Lines with a "*" to the left indicate features only present in the
  224.      registered version of the program.  *** The lines must be present,
  225.      even if the door is not registered. ***
  226.  
  227.      As illustrated above, the door's data file type is specified in line 1
  228.      and can be PCB for PCBoard, GAP for GAP (DOOR.SYS), SF for Spitfire,
  229.      RBBS for RBBS, WC for WildCat!, TRIBBS for TriBBS, or WWIV for WWIV.
  230.      The locked baud rate is specified in line 5.  If you don't lock your
  231.      serial port, you must specify 0 for the locked baud rate.
  232.      The following is a sample door configuration file:
  233.  
  234.      WC                             <== BBS Type
  235.      C:\WC30\WCWORK\NODE1           <== Drop file location
  236.      WCS Software BBS               <== BBS Name
  237.      Rob Williams                   <== Sysop Name
  238.      0                              <== Locked baud rate
  239.      C:\WC30\BULL\BULL10.BBS        <== ASCII bulletin
  240.      C:\WC30\BULL\BULL10.SCR        <== ANSI bulletin
  241.      C:\WC30\COMMENTS.DRS           <== File name to write comments to
  242.      10                             <== # of questions per day
  243.      2                              <== Extra days allowed for make up days
  244.      10                             <== Day to start make up days
  245.      YES                            <== Write a log file (TRIVIA.nodenumber)
  246.      By WCS Software                <== Donated by line
  247.      Y                              <== InterBBS Play (Y or N)
  248.  
  249.      ************************************************************************
  250.      ** IMPORTANT - Even if the game is not registered, the last  three    **
  251.      ** lines must exist, or the game will not run.  You will get an error **
  252.      ** when the game starts up.                                           **
  253.      ************************************************************************
  254.  
  255.      On line 12, the valid options for a log file are:
  256.         - P for Play log ONLY  (WCSUNO.nodenumber)
  257.         - N for No logs
  258.         - C for Comments log ONLY (COMMENTS.MSG)
  259.         - A for ALL Logs (play log and comment log)
  260.  
  261.      PJ Trivia can be run locally without a door data file (handy
  262.      for the sysop to use the door without logging on to the BBS) by
  263.      specifying /L after the  configuration  file  parameter in  the  DOS
  264.      command line.  PJT will request you to enter your name before running
  265.      the door.
  266.  
  267.      To play the game in Multiuser mode, you must have a registered multinode
  268.      copy,and DOS SHARE must be loaded.  If these two things are not done,
  269.      the game will display a message if you try to run multinode.
  270.  
  271.      Nonstandard IRQs can be used by specifying the IRQ number after the
  272.      "config" parameter in the command line used to run the door as
  273.      follows:
  274.  
  275.      TRIVIA TRIVIA.CFG 4
  276.  
  277.  
  278.               Setting up PJ Trivia for Multinode Play
  279.               -----------------------------------------------
  280.  
  281.     In order to set Trivia up for multinode play, you need to create a
  282.     .cfg file for each node that will be using the game.  The .cfg files
  283.     will be similar, except that lines 2 and possibly 5 will be different.
  284.     Line 2 is the location of the door drop file.  This needs to be unique
  285.     for each node that runs the game.  Line 5 is the locked baud rate for
  286.     the node.  If you have nodes that are locked at different rates, then
  287.     this line may be different for different nodes.  For example, the
  288.     configuration file for node 1 (TRIVIA.CF1) might look like this:
  289.  
  290.       GAP
  291.       H:\WILDCAT\WCWORK\NODE1     <=== Notice this is the node 1 directory
  292.       Williams Computer Services BBS
  293.       Rob Williams
  294.       19200
  295.       [etc].....
  296.  
  297.     And the configuration file for node 2 (TRIVIA.CF2) might look like this:
  298.  
  299.       GAP
  300.       H:\WILDCAT\WCWORK\NODE2     <=== Notice this is the node 2 directory
  301.       Williams Computer Services BBS
  302.       Rob Williams
  303.       19200
  304.       [etc].....
  305.  
  306.     You will also need to set an environment variable to tell the program
  307.     what node it is currently running on.  Since I run Wildcat, I call
  308.     this variable WCNODEID.  In my .BAT file that calls the BBS, I set the
  309.     WCNODEID to whatever node is running.  You can use wahtever name you
  310.     wish, it just needs to be a unique node ID.
  311.  
  312.     Next, in the batch file that calls PJT, you would change the sample.bat
  313.     that is included with this archive to look like this:
  314.  
  315.        CD\TRIVIA               
  316.        TRIVIA TRIVIA.CF%WCNODEID%
  317.  
  318.     What this will do, is when the game is started, it will look for the
  319.     WCNODEID (or whatever you called it), and append that to TRIVIA.CF.  So
  320.     when the game runs, and you run it from node 1 say, it will use .cfg file
  321.     TRIVIA.CF1.
  322.  
  323.     Hopefully, I have not totally confused you on how to set the door up for
  324.     mult-node use.  If you have questions on environment variables, refer
  325.     to your DOS manual.
  326.  
  327.    **************************************************************************
  328.    ** Running this game on more than a single node requires a Multi-Node   **
  329.    ** Key.  When running in Evaluation mode, only one (1) Node will be able**
  330.    ** to access the door at a time.                                        **
  331.    **************************************************************************
  332.  
  333.  
  334.  
  335.                             Playing the Game
  336.                             ----------------
  337.      PJ Trivia was named that for a reason.  It is VERY simple
  338.      to play.  When you go into the door, you will see an opening screen,
  339.      wait for you to press a key, then show you the main menu.  From here,
  340.      there are four options.  P will take you to the playing screen, H will
  341.      show you the high score list, I will show you a help file for playing
  342.      the game, and Q will return you to the BBS.
  343.  
  344.      When the play option is chosen, it will take you into the playing
  345.      screen.  There are three menu options that can be chosen at any time.
  346.      R for redraw the screen, H for viewing the high score bulletin, and
  347.      Q to quit the current game.  After quitting, if the game is registered,
  348.      and it is past the extra day set up in the .cfg file, and you have
  349.      not played too many games (as set in the .cfg file), you will be asked
  350.      if you want to play make-up days.  (how is that for a run-on sentence?)
  351.      If you answer no, you will be asked if you want to view the high scores.
  352.      If you answer no to this, you will be returned back to the BBS.
  353.  
  354.      When a question appears, all you need to do is press the answer you
  355.      think is correct, and it will tell you if you were right or not, and
  356.      then display another question.  When you have answered the maximum
  357.      number of questions (as determined in the trivia.cfg file), if make up
  358.      days are enabled and you have not played too many times today, you will
  359.      then be asked if you want to play make up days.  If you say yes, you
  360.      will see a screen showing what days are available for you to play.
  361.      Choose a day and press enter, or choose 99 to exit.  After finishing
  362.      playing, you will be asked if you wish to view the high scores.  After
  363.      viewing the high scores, you will then see a screen while it is writing
  364.      the bulletin, and then be returned to the BBS.  Pretty simple!
  365.  
  366.      The first time a player plays the game each month, the system will
  367.      automatically reset the player and question statistics.  The player
  368.      statistics are the number of questions attempted, and the number of
  369.      correct guesses.  The question statistics are the number of times that
  370.      question has been asked, and the number of correct answers.  The high
  371.      score table will also be reset, and the last months hi scorer and all
  372.      time hi scorer will be recomputed.  This process should not take more
  373.      than a few seconds, and is automatic, so no intervention from the Sysop
  374.      is necessary.
  375.                            
  376.                            Make-Up Days Explanation
  377.                            ------------------------
  378.  
  379.      The make up days feature warrants a little more explanation here.
  380.      When the game is registered, after you have played your game for today,
  381.      it will check to see if make up days has been enabled (start day < 31).
  382.      If today is greater than the start day, and the total number of days you
  383.      have played is not greater than what was specified in the .cfg file, it
  384.      will ask you if you want to play a make up day.  It will then show a
  385.      calendar of days for the current month.  Days that you have played will
  386.      show up in red with an x, playable days will show up in green with an o.
  387.      Choose a valid date (one with an o, within the current month), and you
  388.      will start another days game.  If you changed your mind and do not want
  389.      to play a make up day, enter 99, and you will be asked if you want to
  390.      view the high scores, then be returned to the BBS.
  391.                             
  392.                               Special Keys
  393.                               ------------
  394.                                     
  395.      While PJT is running, the sysop can press certain special keys to
  396.      perform a variety of functions.   The following is a list of the
  397.      functions that the special keys perform:
  398.  
  399.      Key(s)              Function
  400.  
  401.      HOME                Toggles between the user  status window and a help
  402.                          display that lists the special keys.
  403.  
  404.      F6                  Takes 5 minutes away from the caller.
  405.                          NOTE:  This will NOT be returned to BBS.
  406.  
  407.      F7                  Gives 5 minutes to the caller.
  408.                          NOTE:  This will NOT be returned to the BBS.
  409.  
  410.      F9                  Quit the door and return the caller to the BBS.
  411.  
  412.      F10                 Enter  chat mode.  Pressing the  ESC key exits the
  413.                          chat mode.
  414.  
  415.      Alt+D               Drop to DOS.
  416.  
  417.                                  
  418.                                 Support
  419.                                 -------
  420.  
  421.      If you have problems, I will try and help as best I can, whether you
  422.      are registered or not.  Registered users will get priority over non-
  423.      registered users, though.  You may get help with problems by calling 
  424.      Williams Computer Services BBS at (503) 631-8439, or by writing to 
  425.      the author at the following addresses:
  426.  
  427.      FIDO     : 1:105/278
  428.   
  429.      Internet : rob@wcs.org
  430.               : rwilliam@cybernw.com
  431.  
  432.      US Mail:
  433.  
  434.           Rob Williams
  435.           18370 S. Henrici Road
  436.           Oregon City, OR 97045
  437.  
  438.  
  439.                       Registering PJ Trivia
  440.                       -----------------------------
  441.  
  442.      Registration of PJ Trivia is only $15.00 for single node
  443.      or $20.00 for Multi-Node.   Please use the form in the file
  444.      REGISTER.FRM.   When  you register,  you will receive a registration 
  445.      key that will turn your version into a registered version.
  446.  
  447.      Registered users will have access to the special area of the support
  448.      BBS for additional questions, and also be able to add new questions,
  449.      edit questions and users, print questions and users, and import and
  450.      export questions.
  451.  
  452.  
  453.         ***** ALL UPDATES ARE FREE FOR THE LIFE OF THE PROGRAM *****
  454.  
  455.                             Acknowledgements
  456.                             ----------------
  457.  
  458.  Thanks go to the following people/companies (Listed in no particular order):
  459.  
  460.           - Mustang Software for creating Wildcat!
  461.           - Randy Hunt and Mark Goodwin for creating RMDoor which was used
  462.             to create this game.
  463.           - Andy Stewart for his help in fixing the warp and RBBS problems,
  464.             and for his all-around help in general.
  465.           - Mike Jordan for his help with some of the routines, and for the
  466.             idea of the make up days, and also help in testing, and his help
  467.             in helping me get started in door programming.
  468.           - Marcus and Ronda Eikenberry for their help in testing and finding
  469.             a few stubborn bugs.
  470.           - Bob Ainsbury for creating the Turbo Technojock Toolkit, and not
  471.             crippling it.  This toolkit was also used for the TRIVEDIT
  472.             program.
  473.           - Gayle Davis and all the people that have contributed to the 
  474.             SWAG archives.  I have used various snippets from those
  475.             archives, as well as them giving me good ideas on how to
  476.             proceed next.  Thank you.
  477.  
  478. There are probably more people that I have forgotten, but these have been
  479. the most instrumental in the writing of this program.
  480.  
  481.